OpenEuphoria

to_integer

include std/convert.e 
default namespace is convert 
public function to_integer(object data_in, integer def_value = 0) 

Converts an object into a integer.

Parameters:

1. data_in : Any Euphoria object.
2. def_value : An integer. This is returned if data_in cannot be converted into an integer. If omitted, zero is returned.

Returns:

An integer, either the integer rendition of data_in or def_value if it has no integer value.

Comments:

The returned value is guaranteed to be a valid Euphoria integer.

Example 1:

include std/convert.e 
 
? to_integer(12)            --> 12 
? to_integer(12.4)          --> 12 
? to_integer("12")          --> 12 
? to_integer("12.9")        --> 12 
 
? to_integer("a12")         --> 0 (not a valid number) 
? to_integer("a12",-1)      --> -1 (not a valid number) 
? to_integer({"12"})        --> 0 (sub-sequence found) 
? to_integer(#3FFFFFFF)     --> 1073741823 
? to_integer(#3FFFFFFF + 1) --> 0 (too big for a Euphoria integer on 32bit systems) 
? to_integer(#3FFFFFFF + 1) --> 1073741824 (on 64 bit systems)